home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / PACKET / BIS_V20.ZIP / BIS.DOC < prev    next >
Text File  |  1988-09-25  |  32KB  |  688 lines

  1.  
  2.      
  3.      
  4.      
  5.      
  6.                                        BIS
  7.      
  8.                               BBS INTERFACE SYSTEM
  9.      
  10.                               Versions 1.3 and 2.0
  11.      
  12.                              For use with WA7MBL BBS
  13.                              versions 3.30 and above
  14.      
  15.                                 Copyright 1988 by
  16.      
  17.                                 Richard K. Helman
  18.      
  19.                                         -1-
  20.      
  21.      
  22. (*) Indicates changes in documentation with version 2.0.  Consult docu-
  23.     mentation for version 2.0.     
  24.      
  25.                              BBS INTERFACE SYSTEM
  26.      
  27.      
  28.      INTRODUCTION
  29.      
  30.      BIS is a User interface designed to be called from the WA7MBL packet
  31.      BBS program using the OS command.  BIS interfaces to yet a third
  32.      program which is capable of performing file and/or directory
  33.      searches or may interface to other applications which you may specify.
  34.      The SEARCH function of BIS accepts additional parameters
  35.      which the BBS user sends in addition to the command OS, screens and
  36.      edits this information then passes it on to the search program.  If
  37.      user information is incomplete or in error, BIS will so inform the
  38.      user, provide useful help information and terminate, returning to the
  39.      BBS program awaiting to be called again.
  40.      
  41.      BIS grew out of my lengthy bout with frustration over keeping index
  42.      and supplementary lists up to date so that a user desiring to find a
  43.      particular file contained on the BBS hard disk could easily do so. 
  44.      It was very difficult for a user to use the W command if he expected
  45.      to get some idea of what was contained in each of the cryptic file
  46.      names stored in various subdirectories.  Originally, I developed an
  47.      INDEX for each of these subdirectories and faithfully kept them
  48.      updated each time a new file was added.  The process grew old fast. 
  49.      Miraculously, about that time, Jeff's new version 3.3 of the MBL BBS
  50.      program came out with the new OS feature which allows shelling to DOS
  51.      to perform some other function.  In talking with Jeff, he assures me
  52.      that he intends to keep the OS function in future MBL BBS updates. 
  53.      THANKS JEFF!
  54.      
  55.      Index files and their like are no longer needed thanks to this new
  56.      command.  BIS will allow a user to search any file, series of files
  57.      or subdirectory for a particular search word using a supplementary
  58.      searching program such as the one included on this distribution
  59.      diskette.  Although there are other options, normally the result of
  60.      the search through a particular subdirectory is to return the first
  61.      line of each file that contains the particular search word.  The
  62.      system can also be configured to return every line in a file that
  63.      contains the search word making it useful for searching lists such as
  64.      digipeater or PBBS listings etc.
  65.      
  66.      The search program that is used in conjunction with BIS is called
  67.      FGREP and is included on this distribution diskette.  It was chosen
  68.      because of its small size, speed and features.  FGREP was written and
  69.      copyrighted by Christopher J. Dunford.  It comes with its own
  70.      documentation and distribution allowances.  Please take time before
  71.      attempting to run BIS to become familiar with FGREP and its
  72.      capabilities.  You will find it to be an excellent search program and
  73.      highly suited to the purpose we are putting it to in conjunction with
  74.      the BBS program.
  75.                                         -2-
  76.      
  77.      
  78.      
  79.      
  80.      PRECAUTIONS
  81.      
  82.      This program has been tested on an Equity I PC and a Tandy 1000 PC. 
  83.      It has run without problem for approximately six months on the
  84.      W9LZQ-1 PBBS.  It has NOT been tested under multi-tasking
  85.      environments, with DesqView or DoubleDos.  It has NOT been tested
  86.      with previous versions of the MBL PBBS program.  Running this program
  87.      on any computer not utilizing a hard disk is not practical since file
  88.      storage is extremely limited on such systems.  Internal memory must
  89.      be sufficient to run both programs in addition to the BBS program.
  90.     |If you attempt to run BIS and the only thing that happens is the
  91.     |screen clears and jumps right back to the BBS program without making
  92.     |an entry in the BIS.LOG file, more than likely the problem is not
  93.     |enough memory to accomodate all the programs loaded.  Some TSR
  94.     |programs may also present this symptom.
  95.  
  96.      As with any new software, you are highly advised to make a complete
  97.      backup of your hard disk before attempting to run BIS.  You should
  98.      normally be in the habit of doing this before trying any new software
  99.      on your system.
  100.      
  101.  
  102.     |BIS currently runs on only COM ports 1 and 2.  It will not work with
  103.     |ports 3 and above.  If you are running a multi-port system, it will
  104.     |be necessary for you to reconfigure your system so that the users who
  105.     |commonly make use of BIS and its functions are on ports 1 and/or 2. In
  106.     |addition, you will need to have COMBIOS loaded or either COM1BIOS or
  107.  (*)|COM2BIOS, depending upon your situation.  Consult the MBLBBS manual
  108.     |for more information on these drivers.
  109.  
  110.     |It is highly important that your path be set correctly.  Both BIS and
  111.     |its accompanying SEARCH program (FGREP) must be in your current path.
  112.     |Also, COMMAND.COM must be in your current path.  For example, assuming
  113.     |COMMAND.COM is located in your root directory and the MBLBBS program,
  114.     |BIS.EXE and FGREP.COM are all in a directory called BBS, your path
  115.     |would be set as follows: PATH C:\;\BBS
  116.     |This is absolutely necessary because BIS must know where to find
  117.     |FGREP.COM and COMMAND.COM.
  118.      
  119.     |Finally, if you have previously been using Index files or something
  120.     |similar to store lists of files in your various subdirectories that
  121.     |users can download to see where to find files, it is highly recommended
  122.     |that you retain these files until you are absolutely certain that BIS
  123.     |is operating properly and you will no longer need them.  This is a 
  124.     |normal precaution, but an important reminder.
  125.  
  126.                                   -3-
  127.  
  128.  
  129.  
  130.  
  131.      COPYRIGHT, DISTRIBUTION AND DISCLAIMER
  132.      
  133.      BIS (BBS Interface System) is copyrighted 1988 by Richard K. Helman. 
  134.      It is provided on an "as is" basis with no guarantees as to its
  135.      suitability for any particular purpose.  The author assumes no
  136.      responsibility, either consequential or incidental, for damage to
  137.      equipment or software by using this product.  You utilize this
  138.      software at your own risk.  Although it has been tested on certain
  139.      equipment, the author can make no guarantees that it will work in
  140.      conjunction with such equipment or any other equipment.
  141.      
  142.      The BIS software may be distributed so long as no fee is charged for
  143.      it, so long as the program is unmodified from its original form and
  144.      so long as the documentation files are distributed along with
  145.      the program.  You are NOT AUTHORIZED to distribute modified copies of
  146.      this software without the express written consent of the author. 
  147.      This software may be used only by non-commercial interests and only
  148.      on a not for profit basis.  No fee may be charged to any person
  149.      accessing information on a computer system through utilizing this
  150.      program.  It may not be utilized on telephone bulletin board systems
  151.      which charge a fee for usage.
  152.      
  153.      FGREP.COM and its associated documentation MUST accompany any
  154.      distribution of the BIS software.  FGREP has its own disclaimer and
  155.      conditions for distribution included within its documentation file
  156.      which you must be fully aware of before distributing it.
  157.  
  158.      The distribution diskette should contain the following files:
  159.      BIS.CNF; BIS.DOC; BIS-V20.DOC; BIS-V20.EXE; CHANGES.BIS; DOLOG.BAT;
  160.      ERRORS.BIS; FGREP.COM; FGREP.DOC; NOTE-512.BIS; O.HLP; OSHELP;
  161.      READLOG.EXE; README.BIS; REGISTER.BIS.
  162.  
  163.      If it does not contain these files, you are NOT AUTHORIZED to 
  164.      distribute it to anyone.
  165.                                   -4-
  166.  
  167.  
  168.  
  169.  
  170.      FIRST A BIT ABOUT FGREP
  171.      
  172.      Before dealing specifically with the BIS functions lets first discuss
  173.      the search program FGREP and the specific functions which will be
  174.      used by BIS.  Assuming you have now examined the FGREP documentation,
  175.      you will notice the discussion on FGREP's "switches".  The only ones
  176.      that generally will be needed while run in conjunction with BIS are
  177.      the following:
  178.       
  179.      
  180.      Useful FGREP Switches
  181.      
  182.      -f  causes FGREP to show File header lines for only those files which
  183.      match the search condition.
  184.      
  185.      -1  returns only the first line of a file that matches the search
  186.      condition.
  187.      
  188.      -S  suppresses the File header output and returns only the search
  189.      match.
  190.      
  191.      You may want to experiment with other switches, however for most uses
  192.      in BBS database searches, these three are the only ones to be
  193.      concerned about.
  194.      
  195.      For FGREP to function it needs to be passed certain information when
  196.      called.  The syntax is:
  197.      
  198.        FGREP [switches] {search word} {file or subdirectory}
  199.      
  200.      For example: To find all ARRL Bulletins stored in your ARRL
  201.      subdirectory which contain the word "antenna" you would call FGREP
  202.      using the command:  FGREP -f1 antenna \arrl\*.*
  203.      FGREP then would return the name of the file and the first line of
  204.      text within the file which contained the word "antenna".  This is
  205.      useful for finding particular files when many are stored in the same
  206.      subdirectory.
  207.      
  208.      Another example of usage is when you have a subdirectory devoted to
  209.      lists of BBS's and Digipeaters.  Perhaps you may want to have a
  210.      subdirectory named "DATA" which contains the following files: 
  211.      BBS.TXT; BBS.DAT; BBS.LOC; DIGI.LST; DIGI.TXT
  212.      
  213.      BBS.TXT and BBS.DAT are similar lists which contain a nationwide list
  214.      of Packet BBS stations.  BBS.LOC also contains list of BBS stations
  215.      in your region.  When searching for a particular BBS or location of
  216.      the BBS, you may wish to include all three BBS lists to be searched. 
  217.      Easy to do using FGREP:  FGREP -s milwaukee \data\bbs.*
  218.      
  219.      This will return a list of all BBS's in the Milwaukee area from each
  220.      of the three lists.  Or if you wish to obtain a list of all Iowa
  221.      digipeaters from both digipeater lists: FGREP -s ia \data\digi.*
  222.      (Note: Iowa is normally abbreviated "IA" in these distributed lists.
  223.      
  224.                                   -5-
  225.  
  226.  
  227.  
  228.  
  229.      Are you beginning to see the possibilities for PBBS users?  No longer
  230.      will it be necessary for users to download long listings of BBS's
  231.      just to find a BBS in a particular city or state.  No longer will it
  232.      be necessary for sysops to maintain an extensive index file of files
  233.      contained within subdirectories.  The user can search them until he
  234.      finds the information he is seeking using the BIS interface to FGREP. 
  235.      Experiment with FGREP a bit to get used to its conventions and
  236.      output.
  237.      
  238.      THE BIS INTERFACE
  239.      
  240.      Although FGREP does the search work for BIS, it is BIS which assures
  241.      that the information that the user provides is acceptable and is in
  242.      the proper format in order for FGREP to work.  If not, it will return
  243.      the appropriate error message to the user and return control back to
  244.      the BBS program.  In some instances, it will first send a listing of
  245.      all of the files and databases that can be searched.  It will then
  246.      terminate and return to the BBS program.  It is important to note, as
  247.      its name implies, BIS has the potential of doing many other things
  248.      besides interfacing with a search program.  Other functions have not
  249.   (*)been developed yet with two minor exceptions and I am looking forward
  250.      to hearing from those of you with ideas on implementing other helpful
  251.      functions.  The two minor exceptions are that BIS will return both
  252.      the time and the date to a user who commands: OS TIME
  253.      or OS DATE.  Meanwhile until further developments, the main function
  254.      that BIS is concerned with is "SEARCH".
  255.      
  256.      Since BIS.EXE is specified in the BBS.CNF file as the MS-DOS program
  257.      to run using the OS command, it is not necessary for the user to
  258.      specify which program to run.  Using BIS, however, it is necessary to
  259.      specify which BIS function to use.  In this case, SEARCH is the
  260.      function we are interested in.  The user must also supply two other
  261.      parameters, the file or database to search and the search word.  The
  262.      syntax is:                    OS SEARCH {DATABASE} {SEARCH WORD}
  263.      A typical command would be:   OS SEARCH DIGI CHICAGO
  264.      The BBS program would then shell to the BIS program, passing along
  265.      all of this information along with other necessary data to it.  BIS
  266.      then processes the information passed to it assuring that all is
  267.      error free and editing it in limited instances.  BIS then reads its
  268.      own configuration file (BIS.CNF) to assure that the data can be
  269.      processed and to obtain other necessary information to pass on to
  270.      FGREP.  It then calls FGREP and redirects FGREP's output to the
  271.   (*)particular COM port in use.  The end result is easy database searches
  272.      for packet BBS users.
  273.      
  274.                                         -6-
  275.  
  276.  
  277.  
  278.  
  279.  
  280.      SETTING UP
  281.      
  282.      The following files are necessary for BIS.EXE to function.  They
  283.      should all be in the same subdirectory from which you run the BBS
  284.      program:
  285.      
  286.        BIS.EXE  BIS.CNF  FGREP.COM
  287.      
  288.      In addition, BIS will create BIS.LOG which is a log of BIS usage. 
  289.      The log provides a listing of commands sent to BIS and will be
  290.      helpful to you in tracking usage as well as assisting your BBS users
  291.      in making use of the function.  BIS.LOG may also contain error
  292.      reports if they occur during BIS execution assuming the program can
  293.      recover from the error.
  294.      
  295.      In the same subdirectory as you place other BBS ".HLP" files, you
  296.      will want to include the file O.HLP.  Users can then obtain a help
  297.      file by using the BBS command: ?O
  298.           
  299.      The help file "OSHELP" should be placed in your FILES subdirectory so
  300.      that it may be easily downloaded by users by typing: D OSHELP.
  301.      
  302.      In order for BIS to be executed as the BBS OS command, you will need
  303.      to place BIS.EXE on the OS line in your MBL BBS.CNF file.  This
  304.      informs the BBS program of which command or program to execute.
  305.                                   -7-
  306.      
  307.      
  308.      
  309.      THE BIS.CNF FILE
  310.      
  311.      
  312.      4800,N,8,1, 
  313.      12 
  314.      [EXCLUDED CALLS] 
  315.      \BBS 
  316.      XXXXXXXXX 
  317.      ---------- 
  318.      SEARCH 
  319.      DIGI      U.S. digipeaters 
  320.      N 
  321.      FGREP -F 
  322.      \BBS\DATA\DIGI.TXT 
  323.      ---------- 
  324.      SEARCH 
  325.      BBS       U.S. packet Bulletin Boards 
  326.      N 
  327.      FGREP -F 
  328.      \BBS\DATA\BBS.* 
  329.      ---------- 
  330.      SEARCH 
  331.      ARRL      [S] Current year ARRL Bulletins 
  332.      N 
  333.      FGREP -1F 
  334.      \BBS\FILES\ARRL\*.* 
  335.      ---------- 
  336.      SEARCH 
  337.      LIBRARY   [S] BBS files of a general nature 
  338.      N 
  339.      FGREP -1F 
  340.      \BBS\FILES\LIBRARY\*.* 
  341.      ---------- 
  342.      
  343.      The BIS configuration file consists of up to 21 sections, each
  344.      containing exactly six lines each.  The first section contains
  345.      important information on configuring the BIS program for
  346.      communication output, etc.  The remaining sections are keyed to BIS
  347.   (*)functions (with this version, only the SEARCH function) and
  348.      individual "databases" a user can access by using the SEARCH
  349.      function.  They contain database information as well as configuration
  350.      information for FGREP.
  351.                                         -8-
  352.      
  353.      
  354.      
  355.      
  356.      Closely examine the first section.  This section MUST always be the
  357.      first section in the configuration file and the first line MUST be
  358.      the first line in the file.  No blank lines are allowed.  The first
  359.      line is the COM port configuration you are using between your
  360.      computer and the TNC(s).  If you are using different configurations
  361.      with each COM port, BIS will not work with all of them.  It will only
  362.      work with ports configured as in the first line.  Each parameter is
  363.      separated by commas and the line is ended with a comma.  The
  364.      parameters are: baud rate, parity, word length, stop bits,
  365.      
  366.      The second line lists the COM ports with which it is acceptable to
  367.      use BIS.  If the COM port the user is currently connected to is not
  368.      listed, BIS will terminate, returning control back to the BBS
  369.      program.  In this case, ports 1 and 2 are acceptable and each is
  370.      configured as in line 1. NOTE: Only ports 1 and 2 are allowed.
  371.      
  372.      Line three is hopefully unnecessary, but is included as an ounce of
  373.      prevention.  If for some reason it becomes necessary to exclude
  374.      certain call signs from using the OS functions, the call sign may be
  375.      placed on this line.  All excluded call signs should be placed on
  376.      line number 3, separated by spaces, with a maximum line length of 255
  377.      characters.
  378.      
  379.   (*)Line four contains the name of the directory from which you run the
  380.      MBL BBS program.  It is required because during its execution, BIS
  381.   (*)will change directories and it needs to know where to return when it
  382.      has finished.
  383.      
  384.   (*)Line five of this section is reserved for further expansion.
  385.      
  386.      Line six is a series of ten "-" characters required in order to
  387.      appropriately separate each of the sections.  It MUST be the sixth
  388.      line in EVERY section of the BIS configuration file.
  389.      
  390.      The following sections may be in any order but their format must be
  391.      exactly as shown.  Subsequent sections begin with the particular BIS
  392.      function to be used.  Since the current version of BIS has only the
  393.   (*)SEARCH function implemented, all sections will begin with the word
  394.      "SEARCH" (TIME and DATE are BIS internal functions and do not require
  395.      information from the these sections).  The first line in all sections
  396.      MUST BE UPPERCASE.  The second line, for lack of a better definition
  397.      is the name of the database the users is interested in searching.  It
  398.      may be any name up to eight characters in length, MUST BE IN
  399.      UPPERCASE, and for simplicity sake should probably be given a name
  400.      consistent with the files that will be searched.  Following the
  401.      database name is a description of that database which must begin in
  402.      the eleventh (11th) column or beyond of line 2.  This information if
  403.      helpful for the user when BIS sends a listing of databases available
  404.      and their descriptions.  The third line tells BIS whether or not to
  405.      make the search case sensitive.  In most all cases, it is best to use
  406.      N since case sensitivity can really make it difficult for a user to
  407.      find anything.  If you desire case sensitivity, change the line to Y. 
  408.      The fourth line contains the name of the search program and switches
  409.      to pass to it.
  410.                                         -9-
  411.      
  412.      
  413.      
  414.      
  415.      The fifth line tells BIS where to locate the database 
  416.      information including subdirectory and filename.  You will note that
  417.      for filenames, wild cards are acceptable making it easy to search
  418.      through every file contained in a particular subdirectory.
  419.      
  420.      Examine the third section of the configuration file.  You will see
  421.      that the SEARCH in this instance will be of the "BBS" database, not
  422.      case sensitive, using FGREP -F (switched to return the file name from
  423.      which it finds the match), and the search will be conducted of all
  424.      files beginning with "BBS" and with any extension which are contained
  425.      in the \BBS\DATA subdirectory.
  426.      
  427.      Now look at section four.  This will cause a SEARCH of the ARRL
  428.      database which consists of all files in the \BBS\FILES\ARRL
  429.      subdirectory.  FGREP is switched to return the name of the file and
  430.      the first line within that file that matches the search word. 
  431.      Section five does the same thing for all files in the
  432.      \BBS\FILES\LIBRARY subdirectory.  Finally, looking at section two,
  433.      you will note that the SEARCH in this instance will be confined to
  434.      only one file "DIGI.TXT" and will return the name of the file as well
  435.      as any line in which the search word is found within that file.
  436.      
  437.      A word about line two is in order.  You will note in the sample BIS
  438.      configuration file that the description beginning in column 11 may
  439.      contain "[S]" at the beginning.  This is a key for users which
  440.      indicates that all files contained within that particular database
  441.      contain a "SUBJECT:" line which describes the contents of that
  442.      particular file.  For example, if the user commands:
  443.      
  444.        OS SEARCH LIBRARY SUBJECT:
  445.      
  446.      he will receive back a complete list of all files in the "LIBRARY"
  447.      database along with the first line in the file which matches the
  448.      "SUBJECT:" search word.  If each of your files in that subdirectory
  449.      contain an "SUBJECT:" line, it makes it easy for a user to get a
  450.      complete list of files and their topics.  It means index files and
  451.      lengthy lists of subdirectory contents are no longer necessary for
  452.      you to mess with.  All you have to do is be sure that each of the
  453.      files in the subdirectory contain the subject line.  Note that the
  454.      colon following the word "SUBJECT" is optional.
  455.      
  456.      Once you set up your BIS.CNF file, DOUBLE CHECK it for accuracy and
  457.      format.  If you run into problems running BIS, the configuration file
  458.      is undoubtedly where the problem is.  The BIS.CNF file used on the
  459.      W9LZQ-1 BBS is included in this distribution as an example which you
  460.      will need to modify to run on your system.
  461.                                         -10-
  462.      
  463.      
  464.      
  465.      
  466.      BIS EDITING OF USER INPUT
  467.      
  468.      BIS in limited instances will do editing on the search word specified
  469.      by the user and will reject the search word in certain cases.  If the
  470.      search word provided is only two characters in length, BIS will
  471.      automatically insert a space before the first letter and a space
  472.      after the second letter, making it effectively 4 characters in
  473.      length.  This provision was included particularly for database
  474.      searches where users are looking for BBS's or Digipeaters in
  475.      particular states.  Most of the current listings being circulated use
  476.      the two letter state designator with no period following it...
  477.      Example: WI for Wisconsin.  BIS automatically inserts the necessary
  478.      spaces.  Since the SEARCH program will match any line that contains
  479.      the search word, you can imagine the result if a two letter search
  480.      word were allowed.  The user could get back matches all the way from
  481.      "wick" to "wizard".
  482.      
  483.      BIS will ignore any leading or trailing spaces in a searchword sent
  484.      by the user.  Example: "[space]TEST[space]" will appear as "TEST" to
  485.      BIS.
  486.      
  487.      BIS will also reject any search word containing an asterisk or
  488.      question mark since wild card matches are not desirable and are not
  489.      really necessary on the BBS system.
  490.      
  491.      The search word may consist of up to two words separated by a space. 
  492.      If a third word is provided, BIS will reject it and search for only
  493.      the first two words (one followed by the other).
  494.      
  495.      Finally, a note about partial words used as search words.  Users may
  496.      want to specify only a portion of a word as a search word which they
  497.      may do by only typing a portion of the word.  Generally, it is best
  498.      to include at least 4 or 5 characters of the word just to avoid
  499.      unwanted matches, but BIS does no editing in such instances.
  500.      
  501.      
  502.      BIS - USER CONSIDERATIONS
  503.      
  504.      Although, BIS is relatively easy to use, help messages assist the BBS
  505.      user who experiences difficulty in utilizing the interface for file
  506.      and database searches.  In addition to including a .HLP file in your
  507.      BBS HELP subdirectory, it is MANDATORY that you make a duplicate of
  508.      the file or create your own help file and include it in your "FILES"
  509.      subdirectory so that a user can use the DOWNLOAD command to get
  510.      instructions on its use.  The file should be named "OSHELP" (no
  511.      extention) as BIS sends a specific message to users referencing this
  512.      file for help purposes.  The "O.HLP" file, however is not mandatory
  513.      and the BIS help messages make no reference to it.
  514.                                         -11- 
  515.      
  516.      
  517.      
  518.      
  519.      The syntax of the OS command used to call the SEARCH function of BIS
  520.      is as follows:
  521.      
  522.        OS SEARCH {database or file}{search word}
  523.      
  524.      Below are examples of various OS commands given to the BBS and the
  525.      resultant messages sent back to the user:
  526.      
  527.      In the first examples, you will be able to see the help messages sent
  528.      back to the user if he sends an incomplete or unacceptable command:
  529.      
  530.      user command> OS
  531.      
  532.      ==BBS INTERFACE SYSTEM==
  533.      
  534.      PLEASE PROVIDE FUNCTION ARGUMENT.
  535.      FOR DATABASE SEARCHES....COMMAND: OS SEARCH [database] [searchword]
  536.      
  537.      ...For assistance in using 'OS' command, download file: OSHELP
  538.      ...Use command: D OSHELP
  539.      
  540.      
  541.      user command> OS SEARCH
  542.      
  543.      ==BBS INTERFACE SYSTEM==
  544.      YOU NEED TO SPECIFY A DATABASE TO SEARCH.
  545.      VALID DATABASES ARE AS FOLLOWS:
  546.      DIGI      U.S. digipeaters
  547.      BBS       U.S. packet Bulletin Boards
  548.      ARRL      [S] Current year ARRL Bulletins
  549.      ARRL87    1987 ARRL Bulletins
  550.      W5YI87    1987 W5YI Newsletters
  551.      LIBRARY   [S] BBS files of a general nature
  552.      HAMS      Call signs, Names, Addresses etc of area amateurs
  553.      ZIPCODES  5 digit Wisc. zip codes and 3 digit zips for U.S. cities
  554.      REPEATERS Wisconsin fm voice repeaters
  555.      TECH      [S] Technical files
  556.      RIVERLAN  [S] Files pertaining to the RiverLAN Packet Association
  557.      GENERAL   [S] General files..if not in the LIBRARY, check here!
  558.      BBSINFO   [S] Files relating to the operation of bbs's, digi's,
  559.                nodes, etc.
  560.      REPORT    [S] NEWSLETTERS: Gateway; ARRL Letter; W5YI Report
  561.      
  562.      THE SUBJECT OF ALL FILES IN A DATABASE
  563.      IDENTIFIED WITH '[S]' MAY BE LISTED BY
  564.      TYPING "OS SEARCH (DATABASE) SUBJECT:"
  565.      
  566.      
  567.                                         -12-
  568.      
  569.      
  570.      
  571.      
  572.      user command> OS SEARCH REPORT
  573.      
  574.      ==BBS INTERFACE SYSTEM==
  575.      NO SEARCH WORD <OR> SEARCH WORD TOO SHORT.
  576.      PLEASE TRY AGAIN.
  577.      
  578.      
  579.      user command > OS SEARCH REPORT ANTENNA
  580.      
  581.      ==BBS INTERFACE SYSTEM==
  582.      05-27-1988  12:47:43
  583.      W9XYZ, HERE IS THE RESULT FOR YOUR SEARCH WORD [ANTENNA]:
  584.  
  585.      **File AL0212.88
  586.      Gale force winds damaged the antenna system at the University of
  587.      **File GW0219.88
  588.      install the antennas, fuel the spacecraft and integrate it with 
  589.      **File AL0408.88
  590.      in the path of an oncoming thunderstorm with radio antennas on 
  591.      **File YI0115.88
  592.      giving the new Novice operator time to build a station, erect
  593.      antennas and prepare for 
  594.      
  595.      THAT'S ALL.
  596.      
  597.      
  598.      The following examples demonstrate other situations:
  599.      
  600.      
  601.      user command> OS SEARCH HAMS W9LZQ
  602.      
  603.      ==BBS INTERFACE SYSTEM==
  604.      05-27-1988  12:48:21
  605.      W9XYZ, HERE IS THE RESULT FOR YOUR SEARCH WORD [W9LZQ]:
  606.  
  607.       W9LZQ   Kent Helman      * (A) 1063 Fairfield St.  Onalaska         
  608.       WI  54650
  609.      
  610.      THAT'S ALL.
  611.      
  612.      
  613.      user command> OS SEARCH LIBRARY POTAT  (note the partial word)
  614.      
  615.      ==BBS INTERFACE SYSTEM==
  616.      05-27-1988  12:51:42
  617.      W9XYZ, HERE IS THE RESULT FOR YOUR SEARCH WORD [POTAT]:
  618.  
  619.      **File RT1LOC87.019
  620.      Indian Dinner #2: Potato and Cabbage Vegetable; Mung Dal; Basmati 
  621.      **File WINEMAKE.TXT
  622.      lack of such an expensive device just squash with a potato
  623.      masher,
  624.      **File POTATO.RCP
  625.      Subject: Blackened potatoes on barbecue grill
  626.      
  627.      THAT'S ALL.                                        -13-
  628.      
  629.      
  630.      
  631.      
  632.      user command> OS SEARCH DIGI NH
  633.      
  634.      ==BBS INTERFACE SYSTEM==
  635.      05-27-1988  12:50:53
  636.      W9XYZ, HERE IS THE RESULT FOR YOUR SEARCH WORD [ NH ]:
  637.  
  638.      **File DIGI.TXT
  639.       N1AYT    1 DIGI ALTON                NH         145.0500 870909 WB2QJA
  640.       K1BKE    1 DIGI CONCORD              NH         145.0500 870909 WB2QJA
  641.      WA1HZK-1  1 DIGI DEERFIELD            NH         145.0500 870909 WB2QJA
  642.      KA1CDE    1 DIGI DERRY                NH         145.0500 870909 WB2QJA
  643.       N1DYL    1 DIGI HILL                 NH         145.0500 870909 WB2QJA
  644.       N1NH     1 DIGI HOLLIS               NH         145.0500 870909 WB2QJA
  645.       W1HJF-1  1 DIGI MT. WASHINGTON       NH         145.0100 870503 K1BC
  646.       W1HJF-4  3 DIGI MT. WASHINGTON       NH         445.5500 870905 K1BC
  647.       K1TR-1   3 DIGI WINDHAM              NH         145.0700 870905 K1BC
  648.      
  649.      THAT'S ALL.
  650.      (please note that "NH" has been expanded to " NH " in the example
  651.      given above, as will any two letter search word)
  652.      
  653.      
  654.      user command> OS SEARCH ARRL SUBJECT:
  655.      
  656.      The results of that command are not shown here because of the number
  657.      of files that would yield, however, it will return the "SUBJECT:"
  658.      line of every file in the ARRL subdirectory.
  659.      
  660.      FINAL COMMENTS
  661.      
  662.   (*)Unfortunately, BIS does not provide output of the file searches on
  663.      your BBS terminal screen while in operation.  It does, however,
  664.      display information about execution of the BIS program. For testing
  665.      purposes, you will need to call your BBS from another packet station
  666.      or enlist the assistance of a fellow ham to run tests.  Although
  667.      probably not totally necessary, it might be worthwhile including
  668.   (*)screen output in a future version.
  669.      
  670.      If you have questions about BIS, please write or send a message to me
  671.      @ W9LZQ-1.  Please, no phone calls.
  672.      
  673.      Kent Helman  W9LZQ
  674.      1063 Fairfield St.
  675.      Onalaska, WI  54650
  676.      
  677.      REGISTRATION
  678.      
  679.      You are encouraged to register this program so that you may be
  680.      notified of updates.  Please do not send disks or mailers in antici-
  681.      pation of updates.  Notices of updates will be sent by mail.  I
  682.      cannot guarantee general distribution of future updates, so it is
  683.      extremely IMPORTANT to register now.  A form has been included for
  684.      your convenience.  Future updates will allow for additional
  685.   (*)interfaces to other functions and will allow you to interface to your
  686.      own program or DOS commands.  In addition, we will be looking for
  687.      ways to improve the SEARCH interface.
  688.